<?php
/**
 * @Author:: HuangYin
 * @DateTime: 2017-01-16 20:01
 *
 * @Description: 接口文档
 */

/**
 * @api {get} admin?limit={limit}&page={page} 管理员 - 列表
 * @apiVersion 1.0.0
 * @apiName getAdminList
 * @apiGroup Admin
 *
 * @apiParam    {int}       limit       每页个数
 * @apiParam    {int}       page        当前页数
 *
 * @apiSuccess {int}        uid         管理员 ID
 * @apiSuccess {string}     phone       电话号码
 * @apiSuccess {string}     real_name   真实姓名
 * @apiSuccess {string}     avatar      图像
 * @apiSuccess {int}        sex         性别[1:男, 2:女]
 * @apiSuccess {int}        role_id     角色[1:店长, 2:店员]
 * @apiSuccess {int}        status      状态[1:正常, 2:锁定, 3:禁用]
 * @apiSuccess {string}     memo        备注
 * @apiSuccess {string}     created_at  创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                  "id": 4,
 *                  "uid": 4,
 *                  "username": "test",
 *                  "phone": "15111223344",
 *                  "real_name": "test",
 *                  "avatar": "/avatar.jpg",
 *                  "sex": 2,
 *                  "role_id": 1,
 *                  "status": 1,
 *                  "memo": "备注",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} admin/{id} 管理员 - 详情
 * @apiVersion 1.0.0
 * @apiName getAdminDetail
 * @apiGroup Admin
 *
 * @apiParam    {int}        uid        管理员 ID
 *
 * @apiSuccess {int}        uid         管理员 ID
 * @apiSuccess {string}     phone       电话号码
 * @apiSuccess {string}     real_name   真实姓名
 * @apiSuccess {string}     avatar      图像
 * @apiSuccess {int}        sex         性别[1:男, 2:女]
 * @apiSuccess {int}        role_id     角色[1:店长, 2:店员]
 * @apiSuccess {int}        status      状态[1:正常, 2:锁定, 3:禁用]
 * @apiSuccess {string}     memo        备注
 * @apiSuccess {string}     created_at  创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                  "uid": 4,
 *                  "username": "test",
 *                  "phone": "15111223344",
 *                  "email": "test@qq.com",
 *                  "real_name": "test",
 *                  "avatar": "/avatar.jpg",
 *                  "sex": 2,
 *                  "role_id": 1,
 *                  "status": 1,
 *                  "memo": "备注",
 *                  "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} admin 管理员 - 创建
 * @apiVersion 1.0.0
 * @apiName createAdmin
 * @apiGroup Admin
 *
 * @apiParam {string}     role_id     角色ID
 * @apiParam {string}     password    密码
 * @apiParam {string}     rePassword  重复密码
 * @apiParam {string}     phone       电话号码
 * @apiParam {string}     real_name   真实姓名
 * @apiParam {string}     avatar      图像
 * @apiParam {int}        sex         性别[1:男, 2:女]
 * @apiParam {int}        memo        备注
 * @apiParam {int}        status      状态[1:正常, 2:锁定, 3:禁用]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "role_id": "1",
 *       "password": "123456",
 *       "rePassword": "123456",
 *       "phone": "15111223344",
 *       "real_name": "test",
 *       "avatar": "/test.jpg",
 *       "sex": 1,
 *       "memo": "Fuck",
 *       "status": 1
 *     }
 *
 * @apiSuccess {int}      id           管理员 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 0
 *          }
 *     }
 */

/**
 * @api {post} admin/login 管理员 - 登录
 * @apiVersion 1.0.0
 * @apiName adminLogin
 * @apiGroup Admin
 *
 * @apiParam {string}       phone       手机号
 * @apiParam {string}       password    密码
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *          "phone": "15111223344",
 *          "password": "123456",
 *     }
 *
 * @apiSuccess {int}        uid         管理员 ID
 * @apiSuccess {string}     phone       电话号码
 * @apiSuccess {string}     real_name   真实姓名
 * @apiSuccess {string}     avatar      图像
 * @apiSuccess {int}        sex         性别[1:男, 2:女]
 * @apiSuccess {int}        role_id     角色[1:店长, 2:店员]
 * @apiSuccess {int}        status      状态[1:正常, 2:锁定, 3:禁用]
 * @apiSuccess {string}     memo        备注
 * @apiSuccess {string}     created_at  创建时间
 * @apiSuccess {Object[]}   menu        菜单['name', 'url', 'icon', 'children':['name', 'url', 'icon']]
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                  "uid": 4,
 *                  "phone": "15111223344",
 *                  "real_name": "test",
 *                  "avatar": "/avatar.jpg",
 *                  "sex": 2,
 *                  "role_id": 2,
 *                  "status": 1,
 *                  "memo": "Fuck",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  "menu": [
 *                      {
 *                          "name": "系统管理",
 *                          "url": "system",
 *                          "icon": "win.png",
 *                          "children": {
 *                              "1": {
 *                              "name": "店员管理",
 *                              "url": "admin",
 *                              "icon": "person.png"
 *                              }
 *                          }
 *                      }
 *                  ]
 *          }
 *      }
 */

/**
 * @api {post} admin/{id} 管理员 - 更新
 * @apiVersion 1.0.0
 * @apiName updatedAdmin
 * @apiGroup Admin
 *
 * @apiParam {int}        id          管理员 ID
 *
 * @apiParam {string}     role_id     角色ID
 * @apiParam {string}     password    密码
 * @apiParam {string}     rePassword  重复密码
 * @apiParam {string}     phone       电话号码
 * @apiParam {string}     real_name   真实姓名
 * @apiParam {string}     avatar      图像
 * @apiParam {int}        sex         性别[1:男, 2:女]
 * @apiParam {int}        memo        备注
 * @apiParam {int}        status      状态[1:正常, 2:锁定, 3:禁用]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "role_id": "1",
 *       "password": "test",
 *       "rePassword": "test",
 *       "phone": "15111223344",
 *       "real_name": "test",
 *       "avatar": "/test.jpg",
 *       "sex": 1,
 *       "memo": "Fuck",
 *       "status": 1,
 *     }
 *
 * @apiSuccess {int}   id           管理员 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} admin/updatePwd/{id}   管理员 - 修改密码
 * @apiVersion 1.0.0
 * @apiName updatedPassword
 * @apiGroup Admin
 *
 * @apiParam {int}        id               管理员 ID
 *
 * @apiParam {string}     password         原始密码
 * @apiParam {string}     newPassword      新密码
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "password": "123456",
 *       "newPassword": "123456789",
 *     }
 *
 * @apiSuccess {bool}       true|false ? 1|0
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": 1
 *     }
 */

/**
 * @api {post} admin/resetPwd/{id}    管理员 - 重置密码
 * @apiVersion 1.0.0
 * @apiName resetPassword
 * @apiGroup Admin
 *
 * @apiParam {int}          id          管理员 ID
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "id": "9527",
 *     }
 *
 * @apiSuccess {bool}       true|false ? 1|0
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": 1
 *     }
 */

/**
 * @api {get} admin/operation?limit={limit}&page={page}&id={id} 日志 - 列表
 * @apiVersion 1.0.0
 * @apiName getAdminLogList
 * @apiGroup Admin
 *
 * @apiParam {int}          limit       每页个数
 * @apiParam {int}          page        当前页数
 * @apiParam {int}          id          管理员 ID
 *
 * @apiSuccess {int}        id          ID
 * @apiSuccess {string}     real_name   真实姓名
 * @apiSuccess {string}     url         url
 * @apiSuccess {string}     action_name 根据 url 返回动作名
 * @apiSuccess {string}     ip          根据 ip 返回地理位置
 * @apiSuccess {string}     created_at  创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                  "id": 4,
 *                  "real_name": "test",
 *                  "url": "15111223344",
 *                  "action_name": "15111223344",
 *                  "ip": "test@qq.com",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} admin/logout    管理员 - 登出
 * @apiVersion 1.0.0
 * @apiName adminLogout
 * @apiGroup Admin
 *
 * @apiSuccess {bool}       true|false ? 1|0
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": 1
 *     }
 */

/**
 * @api {get} faq?limit={limit}&page={page} 常见问题 - 列表
 * @apiVersion 1.0.0
 * @apiName getFaqList
 * @apiGroup Faq
 *
 * @apiParam    {int}       limit       每页个数
 * @apiParam    {int}       page        当前页数
 *
 * @apiSuccess {int}        id          ID
 * @apiSuccess {int}        faq_id      ID
 * @apiSuccess {string}     title       标题
 * @apiSuccess {string}     created_at  创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                  "id": 1,
 *                  "faq_id": 1,
 *                  "title": "test",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} faq/{id} 常见问题 - 详情
 * @apiVersion 1.0.0
 * @apiName getFaqDetail
 * @apiGroup Faq
 *
 * @apiParam    {int}        id          ID
 *
 * @apiSuccess {int}        id          ID
 * @apiSuccess {int}        faq_id      ID
 * @apiSuccess {string}     title       标题
 * @apiSuccess {string}     content     内容
 * @apiSuccess {string}     created_at  创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                  "id": 1,
 *                  "faq_id": 1,
 *                  "title": "test",
 *                  "content": "15111223344",
 *                  "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {get} feedback?limit={limit}&page={page} 反馈 - 列表
 * @apiVersion 1.0.0
 * @apiName getFeedbackList
 * @apiGroup Feedback
 *
 * @apiParam    {int}       limit       每页个数
 * @apiParam    {int}       page        当前页数
 *
 * @apiSuccess {int}        id          ID
 * @apiSuccess {int}        feedback_id ID
 * @apiSuccess {int}        store_id    门店 ID
 * @apiSuccess {int}        quote_id    引用 ID
 * @apiSuccess {int}        content     内容
 * @apiSuccess {string}     created_at  创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                  "id": 1,
 *                  "feedback_id": 1,
 *                  "shop_id": 1,
 *                  "quote_id": 1,
 *                  "content": "Fuck",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {post} feedback 反馈 - 创建
 * @apiVersion 1.0.0
 * @apiName getFeedbackDetail
 * @apiGroup Feedback
 *
 * @apiSuccess {int}        store_id    门店 ID
 * @apiSuccess {int}        quote_id    引用 ID
 * @apiSuccess {int}        content     内容
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "shop_id": 1,
 *       "quote_id": 1,
 *       "content": "Fuck",
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} goods?limit={limit}&page={page}&articleNo={articleNo}&barCode={barCode}&name={name}&mnemonic={mnemonic} 商品 - 列表
 * @apiVersion 1.0.0
 * @apiName getGoodsList
 * @apiGroup Goods
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 * @apiParam    {int}       articleNo       货号
 * @apiParam    {int}       barCode         条形码
 * @apiParam    {int}       name            名称
 * @apiParam    {int}       mnemonic        助记码
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        goods_id        ID
 * @apiSuccess {string}     category_name   分类名称
 * @apiSuccess {string}     article_no      货号
 * @apiSuccess {string}     bar_code        条形码
 * @apiSuccess {string}     zh_name         中文名称
 * @apiSuccess {string}     en_name         英文名称
 * @apiSuccess {string}     mnemonic        助记码
 * @apiSuccess {string}     brand           品牌
 * @apiSuccess {decimal}    tax             税额
 * @apiSuccess {decimal}    price           价格
 * @apiSuccess {int}        inventory       库存
 * @apiSuccess {int}        status          状态[1:正常, 2:下架]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                  "id": 1,
 *                  "goods_id": 1,
 *                  "category_name": "水果",
 *                  "article_no": "100001",
 *                  "bar_code": "282017011789920705",
 *                  "zh_name": "香蕉",
 *                  "en_name": "banner",
 *                  "mnemonic": "100001",
 *                  "brand": "水果",
 *                  "tax": "Fuck",
 *                  "price": 50.00,
 *                  "inventory": "Fuck",
 *                  "status": "Fuck",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} goods/{id} 商品 - 详情
 * @apiVersion 1.0.0
 * @apiName getGoodsDetail
 * @apiGroup Goods
 *
 * @apiParam    {int}       goods_id     ID
 *
 * @apiSuccess {string}     category_id     分类 ID
 * @apiSuccess {string}     category_name   分类名称
 * @apiSuccess {string}     article_no      货号
 * @apiSuccess {string}     bar_code        条形码
 * @apiSuccess {string}     zh_name         中文名称
 * @apiSuccess {string}     en_name         英文名称
 * @apiSuccess {string}     mnemonic        助记码
 * @apiSuccess {string}     brand           品牌
 * @apiSuccess {decimal}    tax             税额
 * @apiSuccess {decimal}    price           价格
 * @apiSuccess {int}        inventory       库存
 * @apiSuccess {int}        status          状态[1:正常, 2:下架]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                  "category_id": 1,
 *                  "category_name": "水果",
 *                  "article_no": "100001",
 *                  "bar_code": "282017011789920705",
 *                  "zh_name": "香蕉",
 *                  "en_name": "banner",
 *                  "mnemonic": "100001",
 *                  "brand": "水果",
 *                  "tax": "Fuck",
 *                  "price": 50.00,
 *                  "inventory": "Fuck",
 *                  "status": "Fuck",
 *                  "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} goods 商品 - 创建
 * @apiVersion 1.0.0
 * @apiName createdGoods
 * @apiGroup Goods
 *
 * @apiParam {int}          category_id     分类 ID
 * @apiParam {string}       article_no      货号
 * @apiParam {string}       bar_code        条形码
 * @apiParam {string}       zh_name         中文名称
 * @apiParam {string}       en_name         英文名称
 * @apiParam {string}       mnemonic        助记码
 * @apiParam {string}       brand           品牌
 * @apiParam {decimal}      tax             税额
 * @apiParam {decimal}      price           价格
 * @apiParam {int}          inventory       库存
 * @apiParam {int}          status          状态[1:正常, 2:下架]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "category_id": 1,
 *       "article_no": "100001",
 *       "bar_code": "282017011789920705",
 *       "zh_name": "香蕉",
 *       "en_name": "banner",
 *       "mnemonic": "100001",
 *       "brand": "水果",
 *       "tax": "Fuck",
 *       "price": 50.00,
 *       "inventory": "Fuck",
 *       "status": "Fuck"
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} goods/{id} 商品 - 更新
 * @apiVersion 1.0.0
 * @apiName updatedGoods
 * @apiGroup Goods
 *
 * @apiParam {int}          id              ID
 *
 * @apiParam {int}          category_id     分类 ID
 * @apiParam {string}       article_no      货号
 * @apiParam {string}       bar_code        条形码
 * @apiParam {string}       zh_name         中文名称
 * @apiParam {string}       en_name         英文名称
 * @apiParam {string}       mnemonic        助记码
 * @apiParam {string}       brand           品牌
 * @apiParam {decimal}      tax             税额
 * @apiParam {decimal}      price           金额
 * @apiParam {int}          inventory       库存
 * @apiParam {int}          status          状态[1:正常, 2:下架]
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *       "category_id": 1,
 *       "article_no": "100001",
 *       "bar_code": "282017011789920705",
 *       "zh_name": "香蕉",
 *       "en_name": "banner",
 *       "mnemonic": "100001",
 *       "brand": "水果",
 *       "tax": "Fuck",
 *       "price": 50.00,
 *       "inventory": "Fuck",
 *       "status": "Fuck",
 *       "created_at": "2016-10-11 16:14:06"
 *     }
 *
 * @apiSuccess {int}   id  商品 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} goods/status/{id} 商品 - 更新状态
 * @apiVersion 1.0.0
 * @apiName updatedGoodsStatus
 * @apiGroup Goods
 *
 * @apiParam {int}          goods_id        ID
 *
 * @apiParam {int}          status          状态[1:正常, 2:下架]
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *       "status": 2
 *     }
 *
 * @apiSuccess {int}   id  商品 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} goods/category?limit={limit}&page={page} 商品分类 - 列表
 * @apiVersion 1.0.0
 * @apiName getGoodsCategoryList
 * @apiGroup Goods
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        category_id     ID
 * @apiSuccess {string}     name            分类名称
 * @apiSuccess {int}        status          状态[1:正常, 2:下架]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                  "id": 1,
 *                  "category_id": 1,
 *                  "name": "水果",
 *                  "status": "Fuck",
 *                  "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} goods/category/{id} 商品分类 - 详情
 * @apiVersion 1.0.0
 * @apiName getGoodsCategoryDetail
 * @apiGroup Goods
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {string}     category_id     分类名称
 * @apiSuccess {string}     name            分类名称
 * @apiSuccess {int}        status          状态[1:正常, 2:下架]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                  "category_id": 1,
 *                  "name": "水果",
 *                  "status": "Fuck",
 *                  "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} goods/category 商品分类 - 创建
 * @apiVersion 1.0.0
 * @apiName createdGoodsCategory
 * @apiGroup Goods
 *
 * @apiParam {string}       name            分类名称
 * @apiParam {int}          status          状态[1:正常, 2:下架]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *       "name": "Fuck",
 *       "status": 1
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} goods/category/{id} 商品分类 - 更新
 * @apiVersion 1.0.0
 * @apiName updatedGoodsCategory
 * @apiGroup Goods
 *
 * @apiParam {int}          id              ID
 *
 * @apiParam {string}       name            货号
 * @apiParam {int}          status          状态[1:正常, 2:下架]
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *       "name": "香蕉",
 *       "status": 1
 *     }
 *
 * @apiSuccess {int}   id  商品分类 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} member?limit={limit}&page={page}&keyword={keyword} 会员 - 列表
 * @apiVersion 1.0.0
 * @apiName getMemberList
 * @apiGroup Member
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 * @apiParam    {int}       keyword         关键字
 *
 * @apiSuccess {int}        uid             ID
 * @apiSuccess {string}     phone           电话号码
 * @apiSuccess {string}     number          卡号
 * @apiSuccess {string}     real_name       真实姓名
 * @apiSuccess {string}     memo            备注
 * @apiSuccess {int}        status          状态[1:正常, 2:锁定, 3:禁用]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                      "uid": 1,
 *                      "phone": "15157123839",
 *                      "number": "Fuck",
 *                      "real_name": "Fuck",
 *                      "memo": "Fuck",
 *                      "status": 1,
 *                      "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} member/{id} 会员 - 详情
 * @apiVersion 1.0.0
 * @apiName getMemberDetail
 * @apiGroup Member
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        uid             ID
 * @apiSuccess {string}     phone           电话号码
 * @apiSuccess {string}     number          卡号
 * @apiSuccess {string}     real_name       真实姓名
 * @apiSuccess {string}     memo            备注
 * @apiSuccess {int}        status          状态[1:正常, 2:锁定, 3:禁用]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                  "uid": 1,
 *                  "phone": "15157123839",
 *                  "number": "Fuck",
 *                  "real_name": "Fuck",
 *                  "memo": "Fuck",
 *                  "status": 1,
 *                  "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {get} member/integral?limit={limit}&page={page}&uid={uid} 会员积分 - 列表
 * @apiVersion 1.0.0
 * @apiName getMemberIntegralList
 * @apiGroup Member
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 * @apiParam    {int}       uid             会员 ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        uid             UID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {int}        integral        积分
 * @apiSuccess {int}        type            类型[1:充值, 2:消费, 3:消耗]
 * @apiSuccess {string}     memo            备注
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                      "id": 1,
 *                      "uid": 1,
 *                      "store_id": 1,
 *                      "integral": 1000,
 *                      "type": 1,
 *                      "memo": "Fuck",
 *                      "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} member/integral/{id} 会员积分 - 详情
 * @apiVersion 1.0.0
 * @apiName getMemberIntegralDetail
 * @apiGroup Member
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        uid             UID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {int}        integral        积分
 * @apiSuccess {int}        type            类型[1:充值, 2:消费, 3:消耗]
 * @apiSuccess {string}     memo            备注
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                    "id": 1,
 *                    "uid": 1,
 *                    "store_id": 1,
 *                    "integral": 1000,
 *                    "type": 1,
 *                    "memo": "Fuck",
 *                    "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {get} member/recharge?limit={limit}&page={page}&uid={uid} 会员充值 - 列表
 * @apiVersion 1.0.0
 * @apiName getMemberRechargeList
 * @apiGroup Member
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 * @apiParam    {int}       uid             会员 ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        uid             UID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {decimal}    money           金额
 * @apiSuccess {int}        type            类型[1:充值, 2:消费, 3:消耗]
 * @apiSuccess {string}     memo            备注
 * @apiSuccess {int}        status          状态[1:成功, 2:失败]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                      "id": 1,
 *                      "uid": 1,
 *                      "store_id": 1,
 *                      "money": 1000,
 *                      "type": 1,
 *                      "memo": "Fuck",
 *                      "status": 1,
 *                      "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} member/recharge/{id} 会员充值 - 详情
 * @apiVersion 1.0.0
 * @apiName getMemberRechargeDetail
 * @apiGroup Member
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        uid             UID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {decimal}    money           金额
 * @apiSuccess {int}        type            类型[1:充值, 2:消费, 3:消耗]
 * @apiSuccess {string}     memo            备注
 * @apiSuccess {int}        status          状态[1:成功, 2:失败]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                     "id": 1,
 *                     "uid": 1,
 *                     "store_id": 1,
 *                     "money": 1000,
 *                     "type": 1,
 *                     "memo": "Fuck",
 *                     "status": 1
 *          }
 *      }
 */

/**
 * @api {get} menu?limit={limit}&page={page} 菜单 - 列表
 * @apiVersion 1.0.0
 * @apiName getMenuList
 * @apiGroup Menu
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {string}     name            名称
 * @apiSuccess {string}     url             URL
 * @apiSuccess {string}     icon            ICON
 * @apiSuccess {int}        parent_id       父级 ID
 * @apiSuccess {int}        sort            排序
 * @apiSuccess {int}        status          状态[1:显示, 2:不显示]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                      "id": 1,
 *                      "name": "系统设置",
 *                      "url": "路由",
 *                      "icon": "win.png",
 *                      "parent_id": 1,
 *                      "sort": 1,
 *                      "status": 1,
 *                      "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} menu/{id} 菜单 - 详情
 * @apiVersion 1.0.0
 * @apiName getMenuDetail
 * @apiGroup Menu
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {string}     name            名称
 * @apiSuccess {string}     url             URL
 * @apiSuccess {string}     icon            ICON
 * @apiSuccess {int}        parent_id       父级 ID
 * @apiSuccess {int}        sort            排序
 * @apiSuccess {int}        status          状态[1:显示, 2:不显示]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                      "id": 1,
 *                      "name": "系统设置",
 *                      "url": "路由",
 *                      "icon": "win.png",
 *                      "parent_id": 1,
 *                      "sort": 1,
 *                      "status": 1,
 *                      "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} menu 菜单 - 创建
 * @apiVersion 1.0.0
 * @apiName createdMenu
 * @apiGroup Menu
 *
 * @apiParam {string}     name            名称
 * @apiParam {string}     url             URL
 * @apiParam {string}     icon            ICON
 * @apiParam {int}        parent_id       父级 ID
 * @apiParam {int}        sort            排序
 * @apiParam {int}        status          状态[1:显示, 2:不显示]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *         "name": "系统设置",
 *         "url": "setting",
 *         "icon": "win.png",
 *         "parent_id": 1,
 *         "sort": 1,
 *         "status": 1,
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} menu/{id} 菜单 - 更新
 * @apiVersion 1.0.0
 * @apiName updatedMenu
 * @apiGroup Menu
 *
 * @apiParam {int}        id              ID
 *
 * @apiParam {string}     name            名称
 * @apiParam {string}     url             URL
 * @apiParam {string}     icon            ICON
 * @apiParam {int}        parent_id       父级 ID
 * @apiParam {int}        sort            排序
 * @apiParam {int}        status          状态[1:显示, 2:不显示]
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *         "name": "系统设置",
 *         "url": "setting",
 *         "icon": "win.png",
 *         "parent_id": 1,
 *         "sort": 1,
 *         "status": 1,
 *     }
 *
 * @apiSuccess {int}   id  充值 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} order?limit={limit}&page={page} 订单 - 列表
 * @apiVersion 1.0.0
 * @apiName getOrderList
 * @apiGroup Order
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {string}     store_name      门店名称
 * @apiSuccess {string}     shopkeeper      店主
 * @apiSuccess {string}     phone           店主手机
 * @apiSuccess {string}     tel             门店电话
 * @apiSuccess {string}     number          购物号
 * @apiSuccess {int}        status          状态[1:已确定, 2:未确定]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                     "id": 1,
 *                     "store_id": "15157123839",
 *                     "store_name": "Fuck",
 *                     "shopkeeper": "Fuck",
 *                     "phone": "15111223344",
 *                     "tel": "Fuck",
 *                     "number": "Fuck",
 *                     "status": 1,
 *                     "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} order/{id} 订单 - 详情
 * @apiVersion 1.0.0
 * @apiName getOrderDetail
 * @apiGroup Order
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {string}     store_name      门店名称
 * @apiSuccess {string}     shopkeeper      店主
 * @apiSuccess {string}     phone           店主手机
 * @apiSuccess {string}     tel             门店电话
 * @apiSuccess {string}     number          购物号
 * @apiSuccess {int}        status          状态[1:已确定, 2:未确定]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                    "id": 1,
 *                    "store_id": 1,
 *                    "store_name": "Fuck",
 *                    "shopkeeper": "Fuck",
 *                    "phone": "15111223344",
 *                    "tel": "Fuck",
 *                    "number": "Fuck",
 *                    "status": 1,
 *                    "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} order 订单 - 创建
 * @apiVersion 1.0.0
 * @apiName createdOrder
 * @apiGroup Order
 *
 * @apiParam {int}           store_id        门店 ID
 * @apiParam {string}        store_name      门店名称
 * @apiParam {string}        shopkeeper      店主
 * @apiParam {string}        phone           店主手机
 * @apiParam {string}        tel             门店电话
 * @apiParam {string}        number          购物号
 * @apiParam {int}           status          状态[1:已确定, 2:未确定]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *         "store_id": 1,
 *         "store_name": "Fuck",
 *         "shopkeeper": "Fuck",
 *         "phone": "15111223344",
 *         "tel": "Fuck",
 *         "number": "Fuck",
 *         "status": 1,
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} order/purchasing/{id} 订单 - 发起
 * @apiVersion 1.0.0
 * @apiName updatedOrderPurchasing
 * @apiGroup Order
 *
 * @apiParam {int}           id              ID
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *         "id": 1
 *     }
 *
 * @apiSuccess {int}   id  订单 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} order/cart 订单车 - 列表
 * @apiVersion 1.0.0
 * @apiName getOrderCartList
 * @apiGroup Order
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        store_id        门店 ID
 * @apiSuccess {int}        goods_id        商品 ID
 * @apiSuccess {string}     zh_name         中文名称
 * @apiSuccess {string}     en_name         英文名称
 * @apiSuccess {decimal}    price           商品价格
 * @apiSuccess {int}        counts          商品数量
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              [
 *                  {
 *                     "id": 1,
 *                     "store_id": 1,
 *                     "goods_id": 1,
 *                     "zh_name": "商品名称",
 *                     "en_name": "goods name",
 *                     "price": "20.17",
 *                     "counts": 1,
 *                     "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ]
 *          }
 *      }
 */

/**
 * @api {post} order/cart 订单车 - 创建
 * @apiVersion 1.0.0
 * @apiName createdOrderCart
 * @apiGroup Order
 *
 * @apiParam {int}        goods_id        商品 ID
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *         "goods_id": 1,
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} order/cart/{id} 订单车 - 更新数量
 * @apiVersion 1.0.0
 * @apiName updatedOrderCart
 * @apiGroup Order
 *
 * @apiParam {int}        id        商品 ID
 * @apiParam {int}        counts    商品数量
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *         "counts": 10,
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {delete} order/cart 订单车 - 删除商品[支持批量]
 * @apiVersion 1.0.0
 * @apiName deletedOrderCart
 * @apiGroup Order
 *
 * @apiParam {int}        ids        商品 ID
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *         "ids": [1,2,3],
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {delete} order/cart/clear 订单车 - 清空采购车
 * @apiVersion 1.0.0
 * @apiName OrderCartClear
 * @apiGroup Order
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} registration?limit={limit}&page={page} 登记 - 列表
 * @apiVersion 1.0.0
 * @apiName getRegistrationList
 * @apiGroup Registration
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        type            类型[1:快递损坏,2:自行损坏,3:其他]
 * @apiSuccess {int}        memo            备注
 * @apiSuccess {int}        uid             店员 ID
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                     "id": 1,
 *                     "type": 1,
 *                     "memo": "备注",
 *                     "uid": 1,
 *                     "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} registration/{id} 登记 - 详情
 * @apiVersion 1.0.0
 * @apiName getRegistrationDetail
 * @apiGroup Registration
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        type            类型[1:快递损坏,2:自行损坏,3:其他]
 * @apiSuccess {int}        memo            备注
 * @apiSuccess {int}        uid             店员 ID
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                     "id": 1,
 *                     "type": 1,
 *                     "memo": "备注",
 *                     "uid": 1,
 *                     "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} registration 登记 - 创建
 * @apiVersion 1.0.0
 * @apiName createdRegistration
 * @apiGroup Registration
 *
 * @apiParam {int}        type            类型[1:快递损坏,2:自行损坏,3:其他]
 * @apiParam {int}        memo            备注
 * @apiParam {int}        uid             店员 ID
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *         "type": 1,
 *         "memo": "备注",
 *         "uid": 1,
 *     }
 *
 * @apiSuccess {int}      id              ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} role 角色 - 列表
 * @apiVersion 1.0.0
 * @apiName getRoleList
 * @apiGroup Role
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        name            角色名称
 * @apiSuccess {int}        description     角色描述
 * @apiSuccess {int}        status          状态[1:未激活, 2:已激活]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": [
 *              {
 *                 "id": 1,
 *                 "name": "角色",
 *                 "description": "角色描述",
 *                 "status": 1,
 *                 "created_at": "2016-10-11 16:14:06"
 *              }
 *          ]
 *      }
 */

/**
 * @api {get} role/{id} 角色 - 详情
 * @apiVersion 1.0.0
 * @apiName getRoleDetail
 * @apiGroup Role
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        name            角色名称
 * @apiSuccess {int}        description     角色描述
 * @apiSuccess {int}        status          状态[1:未激活, 2:已激活]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                     "id": 1,
 *                     "name": "角色",
 *                     "description": "角色描述",
 *                     "status": 1,
 *                     "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} role 角色 - 创建
 * @apiVersion 1.0.0
 * @apiName createdRole
 * @apiGroup Role
 *
 * @apiParam {int}        name            角色名称
 * @apiParam {int}        description     角色描述
 * @apiParam {int}        status          状态[1:未激活, 2:已激活]
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *          "name": "角色",
 *          "description": "角色描述",
 *          "status": 1,
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} role/{id} 角色 - 更新
 * @apiVersion 1.0.0
 * @apiName updatedRole
 * @apiGroup Role
 *
 * @apiParam {int}        id              ID
 *
 * @apiParam {int}        name            角色名称
 * @apiParam {int}        description     角色描述
 * @apiParam {int}        status          状态[1:未激活, 2:已激活]
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *          "name": "角色",
 *          "description": "角色描述",
 *          "status": 1,
 *     }
 *
 * @apiSuccess {int}   id  角色 ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} setting?limit={limit}&page={page} 设置 - 列表
 * @apiVersion 1.0.0
 * @apiName getSettingList
 * @apiGroup Setting
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        name            配置名称
 * @apiSuccess {int}        config          配置详情
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                     "id": 1,
 *                     "name": "配置名称",
 *                     "config": "配置详情",
 *                     "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} setting/{id} 配置 - 详情
 * @apiVersion 1.0.0
 * @apiName getSettingDetail
 * @apiGroup Setting
 *
 * @apiParam    {int}        id             ID
 *
 * @apiSuccess {int}        id              ID
 * @apiSuccess {int}        name            配置名称
 * @apiSuccess {int}        config          配置详情
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *                     "id": 1,
 *                     "name": "配置",
 *                     "config": "配置详情",
 *                     "created_at": "2016-10-11 16:14:06"
 *          }
 *      }
 */

/**
 * @api {post} setting 配置 - 创建
 * @apiVersion 1.0.0
 * @apiName createdSetting
 * @apiGroup Setting
 *
 * @apiParam {int}        name            配置名称
 * @apiParam {int}        config          配置详情
 *
 *  @apiParamExample {json} Request-Example:
 *     {
 *          "name": "设置",
 *          "config": "描述"
 *     }
 *
 * @apiSuccess {int}        id          ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {post} setting/{id} 配置 - 更新
 * @apiVersion 1.0.0
 * @apiName updatedSetting
 * @apiGroup Setting
 *
 * @apiParam {int}        id              ID
 *
 * @apiParam {int}        name            配置名称
 * @apiParam {int}        config          配置详情
 *
 * @apiParamExample {json} Request-Example:
 *     {
 *          "name": "配置名称",
 *          "config": "配置详情"
 *     }
 *
 * @apiSuccess {int}      id              ID
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 1
 *          }
 *     }
 */

/**
 * @api {get} shopping?limit={limit}&page={page} 购物 - 列表
 * @apiVersion 1.0.0
 * @apiName getShoppingList
 * @apiGroup Shopping
 *
 * @apiParam    {int}       limit           每页个数
 * @apiParam    {int}       page            当前页数
 *
 * @apiSuccess {int}        id              购物 ID
 * @apiSuccess {int}        uid        	 会员 ID
 * @apiSuccess {string}     out_trade_no    商户购物号
 * @apiSuccess {string}     auth_code       商户授权码
 * @apiSuccess {string}     total_amount    总金额
 * @apiSuccess {string}     trade_no        交易号
 * @apiSuccess {string}     pay_type        支付方式[1:人民币, 2:银行卡, 3:积分兑换, 4:微信, 5:支付宝, 6:会员卡, 7:礼券]
 * @apiSuccess {int}        pay_status      支付状态[1:成功, 2:失败]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "list": [
 *                  {
 *                     "id": 1,
 *                     "uid": 1,
 *                     "out_trade_no": "15157123839",
 *                     "auth_code": "Fuck",
 *                     "total_amount": "Fuck",
 *                     "trade_no": "15111223344",
 *                     "pay_type": "Fuck",
 *                     "pay_status": "Fuck",
 *                     "created_at": "2016-10-11 16:14:06"
 *                  }
 *              ],
 *              "total": 8,
 *              "totalPage": 8,
 *              "currentPage": 8
 *          }
 *      }
 */

/**
 * @api {get} shopping/{id} 购物 - 详情
 * @apiVersion 1.0.0
 * @apiName getShoppingDetail
 * @apiGroup Shopping
 *
 * @apiParam    {int}       id              ID
 *
 * @apiSuccess {int}        id              购物 ID
 * @apiSuccess {int}        uid        	  会员 ID
 * @apiSuccess {string}     out_trade_no    商户购物号
 * @apiSuccess {string}     auth_code       商户授权码
 * @apiSuccess {string}     total_amount    总金额
 * @apiSuccess {string}     trade_no        交易号
 * @apiSuccess {string}     pay_type        支付方式[1:人民币, 2:银行卡, 3:积分兑换, 4:微信, 5:支付宝, 6:会员卡, 7:礼券]
 * @apiSuccess {int}        pay_status      支付状态[1:成功, 2:失败]
 * @apiSuccess {int}        created_at      创建时间
 *
 * @apiSuccessExample Success-Response:
 *     HTTP/1.1 200 OK
 *     {
 *          "code": 200,
 *          "message": "",
 *          "data": {
 *              "id": 2,
 *              "uid": 0,
 *              "admin_id": 1,
 *              "out_trade_no": "20170224115326952",
 *              "auth_code": "20170206110514739",
 *              "trade_no": "0",
 *              "total_amount": "500",
 *              "pay_type": 1,
 *              "pay_status": 1,
 *              "status": 1,
 *              "created_at": "2017-02-24 11:53:26",
 *              "detail": [
 *                  {
 *                      "id": 2,
 *                      "shopping_id": 2,
 *                      "goods_id": 1,
 *                      "zh_name": "香蕉",
 *                      "en_name": "banner",
 *                      "price": "50.00",
 *                      "counts": 1,
 *                      "created_at": "2017-02-24 11:53:26"
 *                  }
 *              ]
 *          }
 *      }
 */